List Managed Endpoints

Route

/v2/endpoint-management/endpoints/list

Description

Query managed endpoints with pagination and filtering by profile, status, OS, version, serial number, and last active window.

Method

POST

Inputs

Parameter	Type	Required	Description
page_request	PageRequest	Yes	Pagination block (page_size, page_token)
filter	EndpointManagementFilter	No	Filter endpoints by IDs, serial numbers, profiles, statuses, severities, hostnames, OS/versions, sensor versions, or last_active_time range

Request Example

{
  "page_request": {
    "page_size": 50
  },
  "filter": {
    "profiles": ["profile-secure-laptops"],
    "statuses": ["active"],
    "oses": ["windows", "macos"],
    "last_active_time": {
      "start_time": "2025-01-01T00:00:00Z",
      "end_time": "2025-01-07T23:59:59Z"
    }
  }
}

Output

Field	Type	Description
type	string	Always "endpoints"
size	integer	Number of endpoints returned
resources	array[Endpoint]	Endpoint objects
page_response	PageResponse	Pagination data (next_id, total)
errors	array[Error]	Any errors

Endpoint Object (key fields)

Field	Type	Description
id	string	Endpoint identifier
hostname	string	Device hostname
machine_serial_number	string	Serial number
os	string	Operating system
os_version	string	OS version
sensor_version	string	Sensor version
profile	ProfileDetails	Assigned profile id/name
statuses_and_actions	array[StatusAndAction]	Health/status indicators
last_active_time	string	Last activity timestamp (ISO 8601)
last_logged_local_username	string	Last local user
deleted	boolean	Deleted flag

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "type": "endpoints",
  "size": 2,
  "resources": [
    {
      "id": "endpoint-123",
      "hostname": "LAPTOP-001",
      "machine_serial_number": "ABC123456",
      "os": "windows",
      "os_version": "Windows 11",
      "sensor_version": "24.03.90.366",
      "profile": {
        "profile_id": "profile-secure-laptops",
        "profile_name": "Secure Laptops"
      },
      "statuses_and_actions": [
        {"status": "healthy", "action": "none"}
      ],
      "last_active_time": "2024-01-15T10:30:00Z",
      "last_logged_local_username": "john.doe",
      "deleted": false
    }
  ],
  "page_response": {
    "next_id": "eyJwYWdlX2lkIjoiMiJ9",
    "total": 150
  },
  "errors": []
}